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Overview 


At XDC 2013: presented a proposal for a new Linux OpenGL ABI 
e Define new ABI between applications and OpenGL libraries: 
e Window System libraries: EGL, GLX 
e Client API libraries: OpenGL, OpenGL ES 
e Allow multiple vendor implementations to co-exist on the file system. 
e Allow multiple vendor implementations to co-exist within the same process. 


e Focus is on Linux, but should be applicable to other UNIX and UNIX-like 
platforms. 


In today’s talk: 
e Restate the proposal. 
e Describe what work has been done, and what work is left. 


New Library Organization: Summary 


e Vendor-neutral Client API Libraries: 
e libOpenGL.so.1 
e libGLESv1_CM.so0.1 
e libGLESv2.so.2 


e Vendor-neutral window system libraries: 
e libGLX.so.1 
e libEGL.so.1 


e Vendor-specific libraries: 
e |ibGLX $IVENDOR).so.1 
e libEGL $S(VENDORI.So.1 


New Library Organization: 
Vendor-Neutral Client API Libraries 


e libOpenGL.so.1 
e Provides symbols for OpenGL 4.4 (Core and Compatibility Profiles). 
e Vendors can provide additional OpenGL entry points, through {egl,glx}GetProcAddress. 
e NoEGL or GLX entry points provided by this library; should be used with lib{GLX,EGL}.so.1. 


e libGLESv1_CM.so.1 


e Provides symbols for all OpenGL ES 1 common profile entry points. 
e No EGL or GLX entry points provided by this library; should be used with lib[GLX,EGL).so.1. 


© |libGLESv2.so.2 


e Provides symbols for all OpenGL ES 2 and 3 entry points. 
e No EGL or GLX entry points provided by this library; should be used with lib[GLX,EGL).so.1. 


New Library Organization: 
Vendor-Neutral Window System Libraries 


e libEGL.so.1 
e Provides symbols for all EGL 1.4 entry points. 
e Loads and dispatches to one or more vendor libraries. 


e libGLX.so.1 
e Provides symbols for all GLX 1.4 entry points. 
e Provides symbols for the GLX_ARB_create_context extension. 
e Loads and dispatches to one or more vendor libraries. 


New Library Organization: 
Vendor-Specific Libraries 


e lib{EGL,GLX}_${VENDOR}.so.1 


Provides initialization function that lio{EGL,GLX}.so.1 calls. 
Pulls in the vendor's implementation of all the client APIs it supports. 
Registers with the appropriate Client API library at MakeCurrent time. 
Must not export symbol names that collide with: 

e EGL (“egl.5), 

e GLX (^glX.*), or 

e OpenGL (^gl.*). 


Dispatching to Vendor Implementations 


The vendor-neutral libraries need to dispatch each entry point to a vendor. 


Easy for Client APIs: 
e MakeCurrent defines the vendor to use with the thread. 


Slightly harder for Window System APIs: 
e Many EGL,GLX entry points imply a vendor through their arguments. 
e Some EGL,GLX entry points dispatch based on the current context. E.g., eglWaitGL. 
e Some EGL,GLX entry points return current API state. E.g., gIXGetCurrentContext. 
In nearly all cases, the vendor for a window system entry point can be inferred. 


We are not trying to address server-side GLX (yet), So in practice GLX can 
only have one vendor at a time, per X server, for now. 


Example: lIbGLX.so.1 and libOpenGL.so.1 


X server 


(b) 


> 
| Os 
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( 


Application 


a) 
> libGLX.so.1 
= > libOpenGL.so.1 


a) Application calls any GLX entry point. 
b) libGLX.so.1 queries the X server, to map X screen to vendor. 
c) libGLX.so.1 loads and dispatches to libGLX_${VENDOR}.so. 


d) During glxMakeCurrent, libGLX_${VENDOR}.so registers with libOpenGL.so.1; sets 
up dispatch table. 


e) Application calls OpenGL entry point. 


f) libOpenGL.so.1 jumps through dispatch table to OpenGL implementation registered 
by libGLX_S{VENDOR}.so. 


< (d) 


libGLX_${VENDOR}.so 


Example: lIibEGL.so.1 and libOpenGL.so.1 


a) 
> libEGL.so.1 ZEN 
<£ 
> libOpenGL.so.1 > 
(d) © 
a) Application calls egllnitialize. 


b) libEGL.so.1 uses configuration magic to select, load, and dispatch to libEGL_$ 
{VENDOR}.so. 


c) During eglMakeCurrent, libEGL_${VENDOR}.so registers with libOpenGL.so.1, sets 
up dispatch table. 


d) Application calls OpenGL entry point. 


e) libOpenGL.so.1 jumps through dispatch table to OpenGL implementation registered 
by libEGL_${VENDOR}.so. 


( 


Application libEGL_${VENDOR}.so 


Backwards Compatibility 


There will be a libGL.so.1 provided with the vendor-neutral libraries. 
This exports all symbols from all current vendors’ libGL.so.1's. 


For symbols provided by libGLX.so.1 or libOpenGL.so.1: 
e use ELF DT_FILTER to resolve libGL.so symbols with libGLX.so.1, libOpenGL.so.1. 


For symbols not provided by libGLX.so.1 or libOpenGL.so.1: 


e use libGLX.so.1's glXGetProcAddress to call from libGL.so.1 to libGLX.so.1, 
libOpenGL.so.1. 


Existing applications should be unaffected. 


Status of Implementation 


Linux OpenGL Vendor Neutral Dispatch Library (libglvnd) 
implementation: 


https://gitnub.com/NVIDIA/ibgivnd 


X Server 


Application 


x11glvnd 


libOpenGL 


libGLdispatch és a 
» libGL 
LEGEND: 


A => B: module A calls into module B 
A B: module A is (logically) a filter library on module B (symbols exported by A are resolved by symbols in B) 


libGLdispatch 


e Implements core OpenGL dispatching and TLS. 
Acts as a thin wrapper around glapi (taken from Mesa): 
e Provides dispatch table management. 
e Requests vendor proc addresses from the vendor libraries. 
e Tracks making current to a given context + dispatch table. 
e Separate library rather than statically linked into |ibGLX: 


e Current dispatch tables will eventually be shared between GLX and 
EGL 
e Similar to how glapi operates when Mesa is compiled with the --shared- 
glapi option. 
e Notapplication-visible. 


x11glvnd 


e X extension “XGLVendor” 
e Tracks XID -> screen, and screen -> vendor mappings. 


e libGLX calls this extension to determine the correct vendor to use. 


Implementation Progress 


e We have a working functional prototype for GLX at https:// 
github.com/NVIDIA/libglund 
e Testing: 
@ Unit tests included with libglvnd 
e Prototyped NVIDIA plugging into libglvnd. 


Existing Issues 


e ELF symbol filtering exposes glibc loader bug: 
e https://sourceware.org/bugzilla/show_bug.cgi?id=16272 
e dlopen() of a DSO with a DT FILTER causes the loader to crash 


e ELF symbol filtering: proposed to route libGL symbols to libOpenGL 


e Possible performance problems with the current glvnd/vendor ABI that 
could be fixed. 


e E.g., currently the library calls GetProcAddress() from a vendor one entrypoint at a 
time, rather than retrieving all the vendor's entrypoints at once. 


e Memory management and OOM handling could be improved. 


Next Steps 


e Work to improve robustness of libGLX against various use cases 
(multithreading, fork recovery, library load/unload, etc.) 


e Solicit feedback on Mesa mailing list. 


e Start on lIbEGL. 
@ Need to work out correct vendor selection scheme. 
e Need to work out how libglvnd's libEGL will interact with EGL EXT device base. 


e Other OpenGL implementors can start experimenting with plugging into 
libglvnd, and providing feedback. 


Migration 


e Most likely, deploy with NVIDIA first: 
NVIDIA driver package would include a snapshot of the vendor-neutral 
libraries. 


— If vendor-neutral libraries not already present on system, NVIDIA 
package installs its copies. 


— Get broader testing. 


e Hopefully get feedback from Mesa, AMD on how well it works to plug into 
vendor-neutral libraries. 


e Once we have confidence in it, lock down the ABI between vendor-neutral 
libraries and vendor libraries. 


e Encourage distros to start packaging the vendor-neutral libraries 


Thank You 


All the implementation work so far has been done by Brian Nguyen 
( brnguyen at nvidia.com ) 
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Questions 


